home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / osview.z / osview
Text File  |  1998-10-20  |  17KB  |  331 lines

  1.  
  2.  
  3.  
  4. oooossssvvvviiiieeeewwww((((1111))))                                                            oooossssvvvviiiieeeewwww((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      osview - monitor operating system activity data
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      oooossssvvvviiiieeeewwww [[[[----iiiin]]]] [[[[----nnnnn]]]] [[[[----uuuunamelist]]]] [[[[----ssss]]]] [[[[----aaaa]]]] [[[[----cccc]]]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _o_s_v_i_e_w monitors various portions of the activity of the operating system
  16.      and displays them using the full screen capabilities of the current
  17.      terminal.
  18.  
  19.      A large number of activity counters are monitored, and the display may be
  20.      dynamically altered to hide or show only those counters in which the user
  21.      is interested.  The default is no longer to display all the statistics
  22.      initially, instead there is a selection menu at the bottom of the
  23.      display; enter the number of the selection to switch displays.  See the
  24.      _----_aaaa option for the older behavior.  It is assumed that the _o_s_v_i_e_w user is
  25.      somewhat familiar with the internal workings of an AT&T V.4 based kernel.
  26.  
  27.      _o_s_v_i_e_w lays out as much information as possible in the screen area
  28.      available.  Each data item is grouped similarly to the grouping shown by
  29.      _s_a_r(_1).  A header line gives the group name, and members of the group are
  30.      indented below along with the one-second average value over the last
  31.      interval (or total value over the interval; see below).  If a graphics
  32.      subsystem is not present on the machine being monitored, _o_s_v_i_e_w
  33.      suppresses all graphics related statistics in the display.
  34.  
  35.      The ----iiii parameter sets the delay between screen updates in seconds.  By
  36.      default, a 5 second rate is used.  The ----nnnn parameter is used to override
  37.      the default number of lines to use, which is usually the entire size of
  38.      the display area.  This can be useful if the display is called up in a
  39.      long window, to keep the counters grouped together at the top of the
  40.      window.  The ----ssss option informs _o_s_v_i_e_w to not reduce relevant values to
  41.      the average over a second.  One second averaging allows instant
  42.      performance estimates, but may show inaccuracies because of the short
  43.      interval involved.  The ----aaaa option gives behavior like the older versions,
  44.      with all possible statistics displayed at once (the same as the 0000 option
  45.      on the selection line, if this option isn't given.  The ----cccc option causes
  46.      a running count to be displayed, rather than an interval count.  The
  47.      counts can be reset to zero by pressing the CCCC key.  Finally, the ----uuuu
  48.      option allows the specification of a different namelist file for those
  49.      symbols which must be read from the running kernel.  By default, the
  50.      normal namelist file /_u_n_i_x is used.
  51.  
  52.      In general, those parameters dealing with data throughput rather than
  53.      events are presented as the number of bytes involved.  For instance,
  54.      memory usage is reported in bytes, as well as buffer cache traffic.
  55.      Those parameters dealing with events to the system, such as page fault
  56.      activity, interrupts or system activity are reported as actual counts.
  57.      This allows an instant estimate of the activity and throughput of the
  58.      system.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. oooossssvvvviiiieeeewwww((((1111))))                                                            oooossssvvvviiiieeeewwww((((1111))))
  71.  
  72.  
  73.  
  74.      A group can be suppressed along with all its members to allow hidden
  75.      groups to be brought into view if the screen area is too small.  This is
  76.      done by moving the cursor over the header line of the group to suppress
  77.      and typing a suppression character.  The cursor may be positioned in any
  78.      of the standard ways; keyboard arrow keys, the h-j-k-l keys, or the
  79.      backspace-return-tab keys.  _o_s_v_i_e_w highlights the line the cursor is on
  80.      unless the cursor is on the top screen line (which is reserved for status
  81.      information).  When positioned over a group name, typing the DDDD character
  82.      or one of the _d_e_l_e_t_e keys on the keyboard will suppress the group.  The
  83.      group name will remain, with an asterisk (*) prefix to indicate that the
  84.      group has been suppressed.  The group may be expanded again by
  85.      positioning the cursor over the group name and typing the IIII character or
  86.      one of the _i_n_s_e_r_t keys on the keyboard.  The _h_o_m_e key moves the cursor to
  87.      the _o_s_v_i_e_w status line.
  88.  
  89. OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
  90.      The information which _o_s_v_i_e_w displays and how to interpret it is given
  91.      below.  See the documentation for _s_a_r(_1) or _g_r__o_s_v_i_e_w(_1) for additional
  92.      information.  Some headers, including _S_w_a_p, and _I_n_t_e_r_r_u_p_t_s are suppressed
  93.      by default.  See above description of how to get them to display.  Some
  94.      headers, including _P_a_t_h_N_a_m_e _C_a_c_h_e, _E_f_s_A_c_t, and _G_e_t_b_l_k contain information
  95.      that is subject to change and is of use primarily by IRIX development
  96.      groups.  Tiles information is only displayed if the kernel supports that
  97.      feature.
  98.  
  99.      Load Average
  100.         These counters give load average over the last minute, 5 minutes and
  101.         15 minutes.
  102.  
  103.      CPU Usage
  104.         These counters display the proportion of the available processor
  105.         cycles which were used by each of the following activities.  If
  106.         multiple processors are present, then the CPU number will be added to
  107.         the header line.
  108.  
  109.         uuuusssseeeerrrr      - user programs
  110.         ssssyyyyssss       - system on behalf of user
  111.         iiiinnnnttttrrrr      - interrupt handling
  112.         ggggffffxxxxcccc      - graphics context switching
  113.         ggggffffxxxxffff      - waiting on graphics input FIFO
  114.         ssssxxxxbbbbrrrrkkkk     - waiting for memory
  115.         iiiiddddlllleeee      - doing nothing
  116.  
  117.      Wait Ratio
  118.         These counters display the proportion of time no processes were
  119.         available to run, and any processes were waiting for I/O to complete.
  120.  
  121.         %%%%IIIIOOOO       - waiting on IO
  122.         %%%%SSSSwwwwaaaapppp     - waiting on swap IO
  123.         %%%%PPPPhhhhyyyyssssiiiioooo   - waiting on physical IO
  124.  
  125.      System Memory
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. oooossssvvvviiiieeeewwww((((1111))))                                                            oooossssvvvviiiieeeewwww((((1111))))
  137.  
  138.  
  139.  
  140.         PPPPhhhhyyyyssss      - physical memory size
  141.          kkkkeeeerrrrnnnneeeellll   - memory consumed by kernel text and data
  142.           hhhheeeeaaaapppp    - part of kernel used by heap
  143.            ssssttttrrrreeeeaaaammmm - part of heap used by streams
  144.           zzzzoooonnnneeee    - part of kernel used by zone allocator
  145.           ppppttttbbbbllll    - part of kernel used by process page tables
  146.          ffffssss ccccttttllll   - memory holding filesystem meta-data
  147.          ffffssss ddddaaaattttaaaa  - memory holding filesystem file data
  148.           ddddeeeellllwwwwrrrriiii  - modified filesystem file data
  149.          ffffrrrreeeeeeee     - memory not in use
  150.          uuuusssseeeerrrrddddaaaattttaaaa - in use holding valid user data
  151.          ppppggggaaaalllllllloooocccc  - physical pages allocated from free pool
  152.  
  153.      System Activity
  154.  
  155.         ssssyyyyssssccccaaaallllllll   - system calls
  156.          rrrreeeeaaaadddd     - read system calls
  157.          wwwwrrrriiiitttteeee    - write system calls
  158.          ffffoooorrrrkkkk     - fork system calls
  159.          eeeexxxxeeeecccc     - exec system calls
  160.         rrrreeeeaaaaddddcccchhhh    - characters read via read()
  161.         wwwwrrrriiiitttteeeecccchhhh   - characters written via write()
  162.         iiiiggggeeeetttt      - efs inode searches
  163.  
  164.      Block Devices
  165.  
  166.         llllrrrreeeeaaaadddd     - amount of logical buffer reads
  167.         bbbbrrrreeeeaaaadddd     - amount of physical buffer reads
  168.         %%%%rrrrccccaaaacccchhhheeee   - read hit ratio on buffer cache
  169.         llllwwwwrrrriiiitttteeee    - amount of logical buffer writes
  170.         bbbbwwwwrrrriiiitttteeee    - amount of physical buffer writes
  171.         wwwwccccaaaannnncccceeeellll   - amount of delayed writes cancelled
  172.         %%%%wwwwccccaaaacccchhhheeee   - write hit ratio; negative for write-behind
  173.         pppphhhhrrrreeeeaaaadddd    - amount of raw physical reads
  174.         pppphhhhwwwwrrrriiiitttteeee   - amount of raw physical writes
  175.  
  176.      Swap
  177.  
  178.         ffffrrrreeeeeeeesssswwwwaaaapppp  - amount of free physical swap
  179.         vvvvsssswwwwaaaapppp     - amount of free virtual swap
  180.         sssswwwwaaaappppiiiinnnn    - page swapins
  181.         sssswwwwaaaappppoooouuuutttt   - page swapouts
  182.         bbbbsssswwwwaaaappppiiiinnnn   - bytes swapped in
  183.         bbbbsssswwwwaaaappppoooouuuutttt  - bytes swapped out
  184.  
  185.      System VM
  186.  
  187.         DDDDyyyynnnnaaaammmmiiiicccc VVVVMMMM     - total dynamic system VM
  188.          aaaavvvvaaaaiiiillll    - system VM available
  189.          iiiinnnn uuuusssseeee   - system VM in use
  190.           ffffssss ddddaaaattttaaaa - in use by FS buffer cache
  191.          aaaallllllllooooccccssss   - pages of system VM allocated
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. oooossssvvvviiiieeeewwww((((1111))))                                                            oooossssvvvviiiieeeewwww((((1111))))
  203.  
  204.  
  205.  
  206.          ffffrrrreeeeeeeessss    - pages of system VM freed
  207.  
  208.      Memory Faults
  209.  
  210.         vvvvffffaaaauuuulllltttt    - page faults
  211.         ppppffffaaaauuuulllltttt    - protection faults
  212.         ddddeeeemmmmaaaannnndddd    - demand zero and demand fill faults
  213.         ccccwwww        - copy-on write faults
  214.         sssstttteeeeaaaallll     - page steals
  215.         oooonnnnsssswwwwaaaapppp    - page found on swap
  216.         oooonnnnccccaaaacccchhhheeee   - page found in page cache
  217.         oooonnnnffffiiiilllleeee    - page read from file
  218.         ffffrrrreeeeeeeedddd     - pages freed by paging daemon
  219.         uuuunnnnmmmmooooddddsssswwwwaaaapppp - clean swap page, dirty incore page
  220.         uuuunnnnmmmmooooddddffffiiiilllleeee - clean file page, dirty incore page
  221.         iiiicccclllleeeeaaaannnn    - number of icache cleans
  222.  
  223.      TLB Actions
  224.  
  225.         nnnneeeewwwwppppiiiidddd    - new process ID allocated
  226.         ttttffffaaaauuuulllltttt    - second level TLB misses
  227.         rrrrffffaaaauuuulllltttt    - reference faults (during paging)
  228.         fffflllluuuusssshhhh     - flush of entire TLB
  229.         ssssyyyynnnncccc      - cross-processor TLB synchronizations
  230.  
  231.      Graphics
  232.  
  233.         ggggrrrriiiiiiiiooooccccttttllll  - graphics ioctl's
  234.         ggggiiiinnnnttttrrrr     - graphics interrupts
  235.         sssswwwwaaaappppbbbbuuuuffff   - swapbuffer completes
  236.         sssswwwwiiiittttcccchhhh    - context switches
  237.         ffffiiiiffffoooowwwwaaaaiiiitttt  - wait on FIFO
  238.         ffffiiiiffffoooonnnnwwwwaaaaiiiitttt - wait on FIFO, below low-water mark on check
  239.  
  240.      Tiles
  241.  
  242.         ttttaaaavvvvaaaaiiiillll    - tiles available, no locked pages
  243.          aaaavvvvffffrrrreeeeeeee   - free pages in available tiles
  244.         ttttffffrrrraaaagggg     - tiles fragmented with locked pages
  245.          ffffrrrraaaagggglllloooocccckkkk - locked pages within tfrags
  246.          ffffrrrraaaaggggffffrrrreeeeeeee - free pages within tfrags
  247.         ttttffffuuuullllllll     - tiles full, all pages locked
  248.          ttttttttiiiilllleeee    - tiles allocated
  249.         ppppgggglllloooocccckkkkssss   - tile page locks
  250.         ttttaaaallllllllooooccccmmmmvvvv  - pages relocated for tile_alloc
  251.         ttttiiiilllleeeeddddmmmmvvvv   - pages relocated by tiled daemon
  252.  
  253.      TCP
  254.  
  255.         ccccoooonnnnnnnnssss     - connections accepted
  256.         ssssnnnnddddttttoooottttaaaallll  - packets sent
  257.         rrrrccccvvvvttttoooottttaaaallll  - packets received
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. oooossssvvvviiiieeeewwww((((1111))))                                                            oooossssvvvviiiieeeewwww((((1111))))
  269.  
  270.  
  271.  
  272.         ssssnnnnddddbbbbyyyytttteeee   - bytes sent
  273.         rrrrccccvvvvbbbbyyyytttteeee   - bytes received
  274.  
  275.      UDP
  276.  
  277.         iiiippppaaaacccckkkkeeeettttssss  - packets received
  278.         ooooppppaaaacccckkkkeeeettttssss  - packets sent
  279.         ddddrrrrooooppppppppeeeedddd   - packets dropped
  280.         eeeerrrrrrrroooorrrrssss    - input errors
  281.  
  282.      IP
  283.  
  284.         iiiippppaaaacccckkkkeeeettttssss  - packets received
  285.         ooooppppaaaacccckkkkeeeettttssss  - packets sent
  286.         ffffoooorrrrwwwwaaaarrrrdddd   - packets forwarded
  287.         ddddrrrrooooppppppppeeeedddd   - output errors
  288.         eeeerrrrrrrroooorrrrssss    - input errors
  289.  
  290.      NetIF
  291.         These counters display the activity on a particular network interface.
  292.         If multiple interfaces are present, than a separate set of counters is
  293.         displayed for each interface.  The interface name is displayed as part
  294.         of the header.
  295.  
  296.         IIIIppppaaaacccckkkkeeeettttssss  - packets received
  297.         OOOOppppaaaacccckkkkeeeettttssss  - packets transmitted
  298.         IIIIeeeerrrrrrrroooorrrrssss   - packets received in error
  299.         OOOOeeeerrrrrrrroooorrrrssss   - errors transmitting a packet
  300.         ccccoooolllllllliiiissssiiiioooonnnnssss- collisions detected
  301.  
  302.      Scheduler
  303.  
  304.         rrrruuuunnnnqqqq      - number of processes on run queue
  305.         sssswwwwaaaappppqqqq     - number of processes on swap queue
  306.         sssswwwwiiiittttcccchhhh    - context switches
  307.  
  308.      Interrupts
  309.  
  310.         aaaallllllll       - total interrupts handled
  311.         vvvvmmmmeeee       - VMEBus interrupts
  312.  
  313. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  314.      _gggg_rrrr______oooo_ssss_vvvv_iiii_eeee_wwww(1), _tttt_oooo_pppp(1), _ssss_aaaa_rrrr(1).
  315.  
  316. BBBBUUUUGGGGSSSS
  317.      _o_s_v_i_e_w cannot atomically get all the data it needs.  On a very busy
  318.      system, some percentages could sum to greater than 100, since there could
  319.      be a gap between the time _o_s_v_i_e_w reads the current time and when it reads
  320.      the data counters.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.